.TH E1432_INST 5 E1432
.SH NAME
e1432_inst \- Installing the E1432 distribution
.IX e1432_inst(5) 5
.SH DESCRIPTION

.B "Getting the Latest Distribution Using FTP"

The E1432 distribution is shipped on a DAT tape with the E1432 module.
This distribution includes the E1432 Host Interface library,
associated examples, and manual pages.

The latest version of the E1432 distribution can be obtained via
anonymous FTP, at:

.cS
ftp://hpls01.lsid.hp.com/dsp/products/e1432/software/wk_sta/E1432.X.XX.XX.Z
.cE

.B "Revision Numbering"

The revision string for each release is of the form \fIa.NN.NN\fR, where
"a" is a letter and the "N"s are numbers.  If the letter is an "A",
the release is an official release.  If the letter is an "X", the
release is an interim release which may provide new features or fix
bugs from the previous official release.  For each release, the
numerical part of the revision string increases.

For example, the first official release was \fBA.00.00\fR.  The first
interim release after that was \fBX.00.01\fR.  The second interim
release was \fBX.00.02\fR.  Eventually, the features and fixes from
the interim releases get rolled into an official release, whose label
starts with "A".

For any revision, the revision number of the \fCsema.bin\fR or
\fClib1432.sl\fR file can be found by typing "\fCwhat sema.bin\fR" or
"\fCwhat lib1432.sl\fR".  (If the \fCwhat\fR command is not available,
\fCident\fR might work.)  Both of these probably only work only on unix
machines.  The latest revision number is
.so ../man.rev

.B "Installing the Distribution"

Each file in the FTP directory is a complete release, and will replace
all files in the \fC/opt/e1432\fR and \fC/opt/vxipnp/hpux/hpe1432\fR
directories.  The files in the FTP directory are compressed "update"
files.  Similarly, the DAT tape shipped with an E1432 module contains
an "update" file.  If you are installing onto an HP-UX system, you
would unpack one of these files by doing:

.ne 3
.cS
    cd /                                # Start at root directory
    uncompress E1432.X.XX.XX.Z          # Uncompress the update file
    /etc/update -s /E1432.X.XX.XX '*'   # Unpack the update file
.cE

Alternatively, if you are not on HP-UX, you can use tar to unpack the
update file (an "update" file is really just a tar file with a few
extra files added).  In this case, do this:

.ne 7
.cS
    cd /                                # Start at root directory
    uncompress E1432.X.XX.XX.Z          # Uncompress the update file
    tar -xvf E1432.X.XX.XX              # Unpack the update file
    rmdir E1432 E1432-VXIPNP            # Remove extraneous directories
    rm -f /system/INDEX                 # Remove extraneous file
    rm -f /system/INFO                  # Remove extraneous file
    rm -f /system/CDFinfo               # Remove extraneous file
.cE

See the HP-UX reference manual for information about this command.
You will have to be root to install the E1432 distribution.

The E1432 distribution is normally installed in the \fC/opt/e1432\fR
and \fC/opt/vxipnp/hpux/hpe1432\fR directories.  Under the
\fC/opt/e1432\fR directory there are several subdirectories,
containing include files (in \fCinclude\fR), host interface libraries
(in \fClib\fR), utility programs (in \fCbin\fR), demo programs (in
\fCdemo\fR), example code (in \fCexample\fR), manual pages (in
\fCman\fR), and source code to the Host Interface library (in
\fChostlib\fR).

Older versions of the E1432 distribution (versions A.02.00 and older)
were installed in \fC/usr/e1432\fR rather than \fC/opt/e1432\fR.  If
you have one of these older distributions, it may be necessary for you
to delete the old distribution by hand.  In addition, if you have
existing code that looks for the E1432 distribution in the old place,
it may be necessary for you to create a symbolic link pointing to the
new distribution, by doing this:

.cS
	ln -s /opt/e1432 /usr/e1432
.cE

.B "Printing the E1432 Function Reference"

The E1432 distribution includes manual pages for the E1432 Host
Interface library.  These manual pages can be examined on-line, using
the \fIptman\fR command that is shipped in \fC/opt/e1432/bin\fR.  For
example, you can read the manual page for the
\fIe1432_init_io_library\fR function by typing:

.cS
    ptman e1432_init_io_library
.cE

The distribution also includes several nicely formatted sets of these
manual pages, in various formats for different printers or viewers.
All manuals come with an index at the end which can be a useful list
of the functions that are available.  All of these manuals except the
PDF version are shipped compressed, to save space (the PDF format is
not compressible).  They can be uncompressed with the UNIX
\fIuncompress\fR command.  The formatted manual files that are
available are:

.ne 7
.IP "man.pcl.Z" 15
This is a PCL version of the manual, that can be printed on any PCL
printer (such as an HP laserjet or HP deskjet printer).  Typically,
this manual can be printed by typing:
.cS
    uncompress < /opt/e1432/man/man.pcl.Z | lp -oraw
.cE

.ne 7
.IP "man.pdf" 15
This is a PDF version of the manual.  This file may not be present in
all distributions.

.ne 7
.IP "man.ps.Z" 15
This is a postscript version of the manual, that can be printed on any
postscript printer.  Typically, this manual can be printed by typing:
.cS
    uncompress < /opt/e1432/man/man.ps.Z | lp -opostscript
.cE

.ne 7
.IP "man.txt.Z" 15
This is a plain text version of the manual.  While not as nice as the
postscript or PCL manuals, it can be printed on any line printer.
However, this manual assumes 66 lines per page, which can be annoying
if your printer is configured for only 60 lines per page.
.PP

.SH "SEE ALSO"
.na
ptman(1)
.ad
